home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / contrib / other / seminar / sem-read.me < prev    next >
Text File  |  1995-03-15  |  11KB  |  310 lines
  1. %% BEGIN sem-read.me
  2. ***********************************************************************
  3. ****    "readme" file for seminar.sty package, v1.0, 93/04/01      ****
  4. ***********************************************************************
  5.  
  6. COPYRIGHT 1993, by Timothy Van Zandt, tvz@Princeton.EDU
  7.  
  8. DESCRIPTION:
  9.  
  10.   seminar.sty is a LaTeX document style for typesetting slides or
  11.   transparencies, and accompanying notes. It has many advantages over
  12.   SliTeX. Here are some of the style's special features:
  13.    *  It is a LaTeX style, rather than another format.
  14.    *  It is compatible with AmS-LaTeX.
  15.    *  You can use any fonts that work with LaTeX, including PostScript
  16.       fonts and AmSFonts.
  17.    *  Slides can be landscape and portrait within the same file.
  18.    *  Color is supported through PostScript.
  19.    *  The slides can have a frame and a colored background.
  20.    *  The magnification can be changed with a single command.
  21.    *  Overlays can be produced from a single slide environment.
  22.    *  Accompanying notes, such as the text of a presentation, can be put
  23.       outside the slide environments. The slides, notes or both together
  24.       can then be typeset in a variety of formats.
  25.   Some of these features require a PostScript output device.
  26.  
  27. GETTING SEMINAR.STY
  28.  
  29.   The seminar.sty package is available via anonymous ftp from
  30.     Princeton.EDU:/pub/tvz
  31.   and from the Utrecht, SHSU, Claremont, Aston and Stuttgart TeX archives.
  32.  
  33.   A bug list seminar.bug is kept up-to-date on Princeton.EDU:/pub/tvz.
  34.  
  35.   Send requests to get on or off the seminar.sty mailing list to the author.
  36.  
  37. FILES:
  38.  
  39.   Inputs:
  40.     seminar.sty  : The main style file.
  41.     sem-page.sty : Page parameters.
  42.     semlayer.sty : The semlayer style option (overlays and color layers).
  43.     semhelv.sty  : The semhelv style option .
  44.     semlcmss.sty : The semlcmss style option.
  45.     semcolor.sty : The semcolor style option.
  46.     semrot.sty   : THe semrot style option.
  47.     slidesec.sty : The slidesec style option.
  48.     sem-a4.sty   : The sem-a4 style option.
  49.     xcomment.sty : The macros for omitting notes.
  50.     2up.tex      : Macros for printing documents two-up.
  51.     2up.sty      : The same as 2up.tex, but with .sty extension.
  52.     npsfont.sty  : Macros for defining new PostScript fonts with the NFSS.
  53.     fancybox.sty : Box tips and tricks for LaTeX.
  54.  
  55.   Documentation:
  56.     sem-user.tex : User's guide for seminar.sty.
  57.     sem-user.ind : Index for sem-user.tex.
  58.     semsamp1.tex : A sample document for seminar.sty.
  59.     semsamp2.tex : Another sample document for seminar.sty.
  60.     2up.doc      : Documentation for 2up.tex.
  61.     fancybox.doc : Documentation for fancybox.sty.
  62.     tvz-hax.sty  : For typesetting sem-user.tex and sem-code.tex.
  63.     tvz-code.sty : For typesetting sem-code.tex.
  64.     tvz-user.sty : For typesetting sem-user.tex.
  65.     sem-read.me  : This file.
  66.     read-me.pst  : The read-me file for the PSTricks package.
  67.  
  68.   Sources:
  69.     seminar.doc  : Documented code for seminar.sty.
  70.     semlayer.doc : Documented code for semlayer.sty.
  71.     xcomment.doc : Documented code for xcomment.sty.
  72.     sem-make.tex : For extracting code from seminar.doc and semlayer.doc.
  73.     sem-code.tex : For typesetting seminar.doc and semlayer.doc.
  74.     xc-make.tex  : For extracting code from xcomment.doc.
  75.     xcomment.tex : For typesetting xcomment.doc.
  76.  
  77. GETTING STARTED:
  78.  
  79.   1. Put the input files in a directory where your TeX looks for inputs.
  80.  
  81.   2. Typeset and print sem-user.tex.
  82.  
  83.   3. Read the preface "Getting Started", and then the appendices.
  84.  
  85.   4. Typeset semsamp1.tex and semsamp2.tex.
  86.  
  87.   5  If upgrading from v0.92, see the changes listed at the end of this
  88.      file. If upgrading from v0.91 or earlier, good luck.
  89.  
  90. HACKERS:
  91.  
  92.   The files seminar.doc, semlayer.doc and xcomment.doc contain the
  93.   documented code, using Frank Mittelbach's doc system.
  94.   See sem-code.tex and xcomment.tex for instructions on typesetting
  95.   these files.
  96.   See sem-make.tex and xc-make.tex for instruction on extracting
  97.   stripped input (.sty) files from these .doc files.
  98.  
  99. MORE ABOUT THE SUPPLEMENTAL STYLES AND MACROS:
  100.  
  101.   The following styles and macros are not specifically for use
  102.   with seminar.sty, and hence are not described in detail in
  103.   the seminar.sty User's Guide. You do not need to read the
  104.   documentation of these files in order to use seminar.sty.
  105.   If you have versions on your system that are older than the
  106.   ones distributed with seminar.sty, be sure to replace these.
  107.  
  108.   FANCYBOX.STY:
  109.   fancybox.sty is a LaTeX style option with tips and tricks for LR-box
  110.   commands. The documentation, fancybox.doc, is extensive.
  111.  
  112.   2UP.TEX:
  113.   2up.tex/2up.sty contains macros for typesetting documents in a
  114.   two-up format. seminar.sty's \twoup command provides an interface.
  115.   2up.doc is the documentation for 2up.tex.
  116.  
  117.   NPSFONT.STY:
  118.   npsfont.sty contains macros for defining new PostScript fonts
  119.   with the New Font Selection Scheme. The documentation is in
  120.   npsfont.sty itself.
  121.  
  122.   XCOMMENT.STY:
  123.   xcomment.sty, a LaTeX style option, permits one to typeset only
  124.   selected environments, omitting input outside these environments.
  125.   See xcomment.tex if you want to typeset the documentation.
  126.  
  127.   SLIDESEC.STY
  128.   slidesec.sty is an experimental file contains sectioning commands
  129.   for slide type documents. The documentation is in slidesec.sty
  130.   itself.
  131.  
  132.  
  133. SEMINAR.STY AND PSTRICKS.TEX:
  134.  
  135.   pstricks.tex is a collection of PostScript macros that is compatible
  136.   with most TeX macro packages, including Plain TeX and LaTeX. Included are
  137.   macros for color, graphics, rotation, overlays, nodes and much more.
  138.  
  139.   seminar.sty, combined with the semcolor option, the PSTricks package,
  140.   and your favorite macros for including EPS files, make a complete
  141.   TeX presentation software package.
  142.  
  143.   You can probably obtain the PSTricks package from wherever you got
  144.   the Seminar package, or try
  145.     Princeton.EDU:/pub or Princeton.EDU:/pub/tvz
  146.  
  147.   You must install the PSTricks package before using the semcolor option.
  148.  
  149.   seminar.sty will work with pstricks.tex v0.92, and maybe later
  150.   versions.
  151.  
  152.  
  153. ACKNOWLEDGEMENTS:
  154.  
  155.  The author is thankful to Frank Mittelbach for his documentation system.
  156.  
  157.  Thanks to Sebastian Rahtz for bits of advice, and many users for
  158.  comments and bug reports.
  159.  
  160. COPYING:
  161.  
  162.   Copying of part or all of any file in the seminar.sty package
  163.   is allowed under the following conditions only:
  164.   (1) You may freely distribute unchanged copies of the files. Please
  165.       include the documentation when you do so.
  166.   (2) You may modify a renamed copy of any file, but only for personal
  167.       use or use within an organization.
  168.   (3) You may copy fragments from the files, for personal use or for use
  169.       in a macro package for distribution, as long as credit is given
  170.       where credit is due.
  171.  
  172.   You are NOT ALLOWED to take money for the distribution or use of
  173.   these files or modified versions or fragments thereof, except for
  174.   a nominal charge for copying etc.
  175.  
  176. BUGS:
  177.  
  178.   Too many to list, and who knows what they are anyway. These files are all
  179.   preliminary and unstable. Not responsible for neck injuries.
  180.  
  181.   Please report bugs, enhancements and other comments to
  182.  
  183.              Timothy Van Zandt
  184.              tvz@Princeton.edu.
  185.  
  186.              Department of Economics
  187.              Princeton University
  188.              Princeton, NJ 08544
  189.  
  190.   Thanks.
  191.  
  192. CHANGES:
  193.  
  194.   v1.0: Included sem-a4.sty file, as a way to let the default papersize
  195.      be A4 (The a4 option still works). Added \epsfslidesize to make
  196.      it easier to set the slide of eps files with epsf.sty. Fixed bug
  197.      which caused the width of second pages of a multi-page slide to
  198.      end up too small if the page only contained a quote or similar
  199.      environment with reduced margins.
  200.  
  201.   v0.93a: Fixed bugs so that slides would come out properly with the
  202.           2-up,article and portrait options (together), and so that
  203.           slides would be positioned correctly with the portrait style
  204.           option.
  205.  
  206.   v0.93:
  207.  
  208.   INCOMPATIBLE CHANGES:
  209.  
  210.     !  Use the a4 option instead of sem-a4. There is not longer a
  211.        separate file for a4.
  212.  
  213.     !  No more \fewnotes, \nonotes. Use \slideplacement instead.
  214.  
  215.     !  No more \layerstyle, \overlaystyle.
  216.  
  217.     !  Slide styles are now "left" and "bottom".
  218.  
  219.     !  No more \ifslides. Use \ifarticle\else.
  220.  
  221.     !  You must now use the semlayer option to use overlays (in addition
  222.       to the semcolor option).
  223.  
  224.     !  No "down" slide rotation (only "none", "left" and "right".
  225.  
  226.     !  portrait option is no longer a separate file.
  227.  
  228.     !  \paperwidth and \paperheight are now ordinary commands, to be set
  229.       with \renewcommand.
  230.  
  231.     !  \slidefonts is now always invoked in slide environments, and never in
  232.       the preamble. (But semhelv.sty and semlcmss.sty have changed to
  233.       reflect this.)
  234.  
  235.     !  Method for customizing the slide frames has changed.
  236.        \slideframecolor, \slideframearc, \slidefillcolor and
  237.        \slideshadowcolor are obsolete.
  238.  
  239.     ! \landscape command replaced by \printlandscape to avoid conflict with
  240.       other style files. (E.g., \def\printlandscape{\special{landscape}}).
  241.  
  242.   NEW FEATURES:
  243.  
  244.     +  A slide environment can have multiple `pages'. \extraslideheight{len}
  245.       controls page cutting. See user's guide for details.
  246.  
  247.     +  \centerslidestrue (default) causes the contents of partially full
  248.       slides to be vertically centered in the slide. \centerslidesfalse
  249.       causes it to be flush top.
  250.  
  251.     +  New \raggedslides[len] command, for setting
  252.       whether right margin in slides is ragged or justified. Default is
  253.       \raggedslides. \raggedslides[0pt] gives justified slides.
  254.  
  255.     +  \slideplacement
  256.  
  257.     +  \onlynotestoo
  258.  
  259.     +  \slideskip and \slideshrink for added control over interline space.
  260.  
  261.  
  262.     +  New: \slideleftmargini, \slideleftmarginii, \slideleftmarginiii,
  263.       \slidelabelsep, \slideitemsep, \slidepartopsep,
  264.       \slideparskip, \slideparindent, \slidefootins, \slidefootnotesep,
  265.       \slidedisplayskips, \theslidefootnote
  266.  
  267.     +  \input and \endinput now supported for the slidesonly selection.
  268.  
  269.     +  New conditional: \ifportrait
  270.  
  271.     +  \newslideframe
  272.  
  273.     +  \leftsliderotation, \rightsliderotation.
  274.  
  275.     +  New \slidetopmargin, \slidebottommargin, \slideleftmargin,
  276.        \sliderightmargin.
  277.  
  278.     +  New notesonly* selection.
  279.  
  280.     +  New \slidesclearpagetrue
  281.  
  282.     +  New \semcm and \semin.
  283.  
  284.     +  New note environment and \noxcomment command, as an alternative
  285.        to treating everything outside slide environments as notes.
  286.  
  287.  
  288.   BACKWARDS-COMPATIBLE CHANGES:
  289.  
  290.     *  \maketitle now uses LaTeX's default from article.sty in notes.
  291.  
  292.     *  Bug in article option with the \twoup command fixed.
  293.  
  294.     *  \topmargin in sem-a4 changed from -.75in to 1in.
  295.  
  296.     *  \slidefontsizes is obsolete (but still works). Use \ptsize instead.
  297.  
  298.     *  Page parameters are now in a separate file sem-page.sty. sem-a4.sty
  299.       has been changed to reflect this.
  300.  
  301.   v0.92:
  302.     Mostly bug fixes, plus some extra options. The PSTricks package
  303.     is no longer distributed with seminar.sty.
  304.  
  305.   Pre v0.91:
  306.     Entirely rewritten. Too many changes to list. Note especially
  307.     that system of formats and selections has changed.
  308.  
  309. %% END sem-read.me
  310.